---
title: "open connection · RUAL Documentation"
description: "This interface is used to open a connection to the Aqara service."
canonical: https://docs.rual.nl/block-types/Home Automaton/aqaraconnection_open
language: en
---

# open connection

This block is part of the [`Home Automaton`](https://docs.rual.nl/block-types/Home%20Automaton) group and was last modified in core [`v13.0.8`](https://docs.rual.nl/core-versions/130008).

This interface is used to open a connection to the Aqara service.

- flow `flow`

- App ID required `value` Appid of the third-party application

- Key ID required `value` appKey corresponds to Keyid

- App Key required `value` AppKey of the third-party application

- Access Token `value` Access Token obtained through authorization, if not given the connection can only be used for doing authorization requests.

- flow `flow`

- Connection `aqaraconnection` The aqara connection

- Success `condition` If successful, return true.

- Error `value` Error message if the connection could not be established.

A typical wiring for [open connection](https://docs.rual.nl/block-types/Home%20Automaton/aqaraconnection_open): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `app_id` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `key_id` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `app_key` pin; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the open connection block: typical wiring for open connection.](https://docs.rual.nl/canvas-examples/aqaraconnection_open.png)

### Version history

Introduced in [`v13.0.8`](https://docs.rual.nl/core-versions/130008).